Skip to main content

Advanced Topics

This section outlines advanced concepts referenced in training, including multi-modal development strategies, instructional metadata alignment, and common debugging practices for course authors and administrators.

Overview​

MAXRES Construct supports a range of powerful features and practices for expert users. These advanced topics help organizations maximize flexibility, maintain instructional design fidelity, and troubleshoot issues effectively.

Multi-Modal Development​

Concept​

The core principle is Create Once, Use Many—build content once, then deliver it in multiple ways:

  • Define variations for different audiences
  • Adapt content for different outputs or platforms
  • Apply different themes or presets for branding
  • Use different menu styles to suit learning contexts

Benefits​

  • Reduces redundant work
  • Supports personalization and localization
  • Enhances flexibility in delivery (LMS, offline, ILT supplements)

Device Responsiveness​

Lessons created in MAXRES Construct are mostly responsive by design and adapt layout for:

  • Desktop computers
  • Tablets
  • Mobile devices
  • XR headsets

Metadata Mapping: EOs, TOs, KLPs​

The platform’s content structure (Page, Article, Block) aligns with established instructional design frameworks used in ILT and formal training systems:

Author TermInstructional Mapping
CourseTO – Training Objective
PageEO – Enabling Objective
ArticleTP – Training Point
BlockKLP – Key Learning Point

Applying Metadata​

  • Use consistent naming conventions and tags to track instructional objectives
  • Helps with:
    • Search and content filtering
    • Review and QA alignment with formal curricula
    • Export-based reporting or audit readiness

Debugging Courses​

Two common categories of errors are discussed in the General Training materials:

1. Content Hierarchy Errors​

MAXRES Construct enforces a strict hierarchy:

Course > Page > Article > KLP > Element

Common Issues​

  • An Article missing a Block
  • A Block missing a Component

Troubleshooting Tips​

  • Use descriptive Title fields for all items
  • Structure titles like breadcrumbs:
    "Page 1 > Article 1 > Block 1 > Component 1 Title"
  • These titles help you locate errors in preview/publish logs

2. Custom CSS/LESS Errors​

Custom styling (often in .less files for themes) can cause build failures.

Common Causes​

  • Syntax errors in custom .less code
  • Unsupported variables or nesting in course-level CSS fields

Troubleshooting​

  • Review error output during grunt build or preview failure
  • Errors typically reference:
    • Filename (.less)
    • Line number
    • Type of issue (e.g., missing ;, unmatched brackets)

By applying multi-modal strategies, using metadata conventions, and following effective debugging practices, you can optimize your courses for flexibility, maintain instructional alignment, and troubleshoot efficiently within MAXRES Construct.